org.springframework.test.context

Class DefaultTestContext

java.lang.Object

org.springframework.core.AttributeAccessorSupport

org.springframework.test.context.DefaultTestContext

All Implemented Interfaces:

java.io.Serializable, AttributeAccessor, TestContext

class DefaultTestContext
extends AttributeAccessorSupport
implements TestContext

Default implementation of the TestContext interface.

Although DefaultTestContext was first introduced in Spring Framework 4.0, the initial implementation of this class was extracted from the existing code base for TestContext when TestContext was converted into an interface.

Since:

4.0

Author:

Sam Brannen, Juergen Hoeller

Field Summary

Fields

Modifier and Type	Field and Description
private CacheAwareContextLoaderDelegate	cacheAwareContextLoaderDelegate
private MergedContextConfiguration	mergedContextConfiguration
private static long	serialVersionUID
private java.lang.Class<?>	testClass
private java.lang.Throwable	testException
private java.lang.Object	testInstance
private java.lang.reflect.Method	testMethod

Constructor Summary

Constructors

Constructor and Description
DefaultTestContext(TestContextBootstrapper testContextBootstrapper) Construct a new test context using the supplied TestContextBootstrapper.

Method Summary

Modifier and Type	Method and Description
ApplicationContext	getApplicationContext() Get the application context for this test context, possibly cached.
java.lang.Class<?>	getTestClass() Get the test class for this test context.
java.lang.Throwable	getTestException() Get the exception that was thrown during execution of the test method.
java.lang.Object	getTestInstance() Get the current test instance for this test context.
java.lang.reflect.Method	getTestMethod() Get the current test method for this test context.
void	markApplicationContextDirty(DirtiesContext.HierarchyMode hierarchyMode) Call this method to signal that the application context associated with this test context is dirty and should be discarded.
java.lang.String	toString() Provide a String representation of this test context's state.
void	updateState(java.lang.Object testInstance, java.lang.reflect.Method testMethod, java.lang.Throwable testException) Update this test context to reflect the state of the currently executing test.

Methods inherited from class org.springframework.core.AttributeAccessorSupport

attributeNames, copyAttributesFrom, equals, getAttribute, hasAttribute, hashCode, removeAttribute, setAttribute

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.springframework.core.AttributeAccessor

attributeNames, getAttribute, hasAttribute, removeAttribute, setAttribute

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

cacheAwareContextLoaderDelegate

private final CacheAwareContextLoaderDelegate cacheAwareContextLoaderDelegate

mergedContextConfiguration

private final MergedContextConfiguration mergedContextConfiguration

testClass

private final java.lang.Class<?> testClass

testInstance

private java.lang.Object testInstance

testMethod

private java.lang.reflect.Method testMethod

testException

private java.lang.Throwable testException

Constructor Detail

DefaultTestContext

DefaultTestContext(TestContextBootstrapper testContextBootstrapper)

Construct a new test context using the supplied TestContextBootstrapper.

Parameters:

testContextBootstrapper - the TestContextBootstrapper to use to construct the test context (must not be null)

Method Detail

getApplicationContext

public ApplicationContext getApplicationContext()

Description copied from interface: TestContext

Get the application context for this test context, possibly cached.

Implementations of this method are responsible for loading the application context if the corresponding context has not already been loaded, potentially caching the context as well.

Specified by:

getApplicationContext in interface TestContext

Returns:

the application context

markApplicationContextDirty

public void markApplicationContextDirty(DirtiesContext.HierarchyMode hierarchyMode)

Description copied from interface: TestContext

Call this method to signal that the application context associated with this test context is dirty and should be discarded. Do this if a test has modified the context — for example, by replacing a bean definition or modifying the state of a singleton bean.

Specified by:

markApplicationContextDirty in interface TestContext

Parameters:

hierarchyMode - the context cache clearing mode to be applied if the context is part of a hierarchy (may be null)

getTestClass

public final java.lang.Class<?> getTestClass()

Description copied from interface: TestContext

Get the test class for this test context.

Specified by:

getTestClass in interface TestContext

Returns:

the test class (never null)

getTestInstance

public final java.lang.Object getTestInstance()

Description copied from interface: TestContext

Get the current test instance for this test context.

Note: this is a mutable property.

Specified by:

getTestInstance in interface TestContext

Returns:

the current test instance (may be null)

See Also:

TestContext.updateState(Object, Method, Throwable)

getTestMethod

public final java.lang.reflect.Method getTestMethod()

Description copied from interface: TestContext

Get the current test method for this test context.

Note: this is a mutable property.

Specified by:

getTestMethod in interface TestContext

Returns:

the current test method (may be null)

See Also:

TestContext.updateState(Object, Method, Throwable)

getTestException

public final java.lang.Throwable getTestException()

Description copied from interface: TestContext

Get the exception that was thrown during execution of the test method.

Note: this is a mutable property.

Specified by:

getTestException in interface TestContext

Returns:

the exception that was thrown, or null if no exception was thrown

See Also:

TestContext.updateState(Object, Method, Throwable)

updateState

public void updateState(java.lang.Object testInstance,
                        java.lang.reflect.Method testMethod,
                        java.lang.Throwable testException)

Description copied from interface: TestContext

Update this test context to reflect the state of the currently executing test.

Caution: concurrent invocations of this method might not be thread-safe, depending on the underlying implementation.

Specified by:

updateState in interface TestContext

Parameters:

testInstance - the current test instance (may be null)

testMethod - the current test method (may be null)

testException - the exception that was thrown in the test method, or null if no exception was thrown

toString

public java.lang.String toString()

Provide a String representation of this test context's state.

Overrides:

toString in class java.lang.Object